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Overview 



1. Overview 



This manual is arranged as follows: 

• Chapter 1 (this chapter) describes the Stereo Viewing Option 
components, stereoscopic graphics, and contains a video overview. 

• Chapter 2 describes stereo implementation using PHIGS. 

• Chapter 3 describes stereo implementation using ES/PSX. 

• Appendix A contains a glossary of stereoscopic terms. 

• Appendix B contains a PHIGS stereo example program. 

Stereoscopic Graphics 

When a monoscopic display of a 3D object is viewed on a graphics screen, 
several cues suggest to the eye-brain system that the image represents a 3D 
object: 

• The edges of the object meet at angles which make sense only if the 
brain assumes that the 2D picture is actually a projection of a 3D ob- 
ject. 

• The intensity of edges and other lines in the picture can be made to 
vary, suggesting depth by the dimming of the lines with distance. 

• The object can be drawn in perspective, where the portions of the ob- 
ject which are closer to the viewer are drawn larger than those which 
are farther from the viewer. 

Adequate pictures can be produced with these cues which faithfully re- 
produce an object as it would be viewed from a selected point. However, the 
brain recognizes that only a picture is being viewed, and not the object itself, 
because the most important depth cue, stereopsis, is missing. 

Stereopsis gives viewers the ability to qualitatively and, to some degree, 
quantitatively, judge the distance to an object by how different the object 
looks to each of their two eyes. The difference in appearance between the two 
views is caused by parallax, the apparent shifting of a nearby object with re- 
spect to a far object as the viewer's point of view shifts. The eye-brain system 
is carefully trained to observe this change in appearance and uses it to accu- 
rately judge the relative distance and size of an object. 

To display true 3D, each eye must be made to see a different image, ad- 
justed for the correct parallax. Since the placement of the two-eye system is 
important, the view must be adjusted for the correct position of the viewer 
with respect to the monitor screen. In this way, the screen can be made to ap- 
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pear as a transparent window through which a real 3D object is seen, not as a I 

surface on which a picture is drawn. 

Stereo Viewing Option 

When viewing a 3D object, each eye views the object from a slightly different 
perspective because of the interocular separation. 2D views of the object, 
called stereoscopic fields, are projected onto the retinae of the eyes. The 
stereoscopic fields are transmitted to the brain, and the brain fuses them by a 
process known as stereopsis to form a 3D view of the object 

The Stereo Viewing Option provides the hardware and software tools 
required to create the left-eye and right-eye stereoscopic fields of a 3D object 
on the ES V Workstation; to alternately display the two stereoscopic fields on 
a monitor; and to direct the left-eye stereoscopic field to the left eye and the 
right-eye stereoscopic field to the right eye of the user. 

Stereo on the ESV Workstation 

The ESV Workstation monitor accommodates both monoscopic and stereo- 
scopic viewing of an image. ESV Workstation stereoscopy is non-interlaced, 
which means that each time the monitor screen is refreshed, either the right- 
eye or left-eye stereoscopic field is drawn complete from top to bottom. Two 
refresh cycles are required to draw the complete stereoscopic picture. 

The ESV Workstation monitor has a default resolution of 1280 horizontal 
pixels by 1024 vertical pixels. The pixels are stored in a special memory 
called Xht frame buffer. In the stereoscopic viewing mode, the video hardware 
divides the frame buffer into two equal parts. The first 5 12 scan lines (lines 
through 5 1 1) are used for the first stereoscopic field (e.g., the left-eye view), 
and the second 512 scan lines (lines 512 through 1023) are used for the sec- 
ond stereoscopic field (e.g., the right eye). 

The first 5 12 horizontal scanlines of frame buffer memory are used for the 
left-eye view. These 512 scan lines are displayed across the entire surface of 
the monitor, so that there is now a resolution of 5 12 vertical pixels, rather than 
the original 1024. The image now has pixels that are twice as tall as they used 
to be. While these 512 scanlines are being displayed, the stereoscopic viewing 
device blanks the right lens so that only the left eye can see the left-eye view 
on the monitor. 

The second 512 horizontal scanlines of frame buffer memory are used for 
the right-eye view. While the right-eye view is being displayed, the stereo- 
scopic viewing device blanks the left lens so that only the right eye can see the 
right-eye view on the monitor. Once again, the right-eye view's 512 scanlines 
are displayed across the entire surface of the monitor. 
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Stereoscopic Viewing Device 

The CrystalEyes stereoscopic viewing device is an electrochemical apparatus 
which selects and transmits the stereoscopic field displayed on the monitor to 
the intended eye while blocking the direct vision of the other eye. The device 
synchronizes to an inter-field time interval signal and alters its state to pass 
the subsequent field to the intended eye. The stereoscopic viewing device 
consists of a liquid crystal shutter and a device controller. 

The liquid crystal shutter is an alternate-state, electrochemical, optical 
filter that encodes each stereoscopic field with a unique polarization which is 
decoded by a like-polarized lens. The liquid crystal shutter consists of a sheet 
polarizer, light modulator and polarization analyzer. 

The light modulator consists of two liquid crystal cells mounted back-to- 
back. When light passes through the modulator, the modulator changes the 
phase of one of the components of light with respect to the other, depending 
on the potential applied to its electrodes. When bonded to a sheet polarizer, 
its two states produce circularly-polarized light which is either orthogonal or 
parallel to the sense of each polarization analyzer. 

The polarization analyzer is a circular polarizer which decodes the 
circularly-polarized light passing through it in the following manner. The 
polarization analyzer transmits light of like-handedness, but blocks light of 
opposite-handedness. A set of polarization analyzers consists of a right- 
circular analyzer and a left-circular analyzer, and they are mounted, together 
with the light modulator, in the apparatus which is worn by the user. 

The device controller synchronizes to the display signal, which indicates 
the beginning of the inter-field time interval and changes the light modulator 
state to transmit the next stereoscopic field to the intended eye. The device 
controller is placed on the monitor and it transmits the display signal, by 
means of infrared light, to the apparatus which is worn by the user. 

The CrystalEyes device displays the pair of left-eye and right-eye views 
60 times per second, which means that each eye view is on the screen for only 
l/120thofasecond. 

Stereoscopic Fields 

The stereoscopic fields arc created by the software application running on the 
ESV Workstation. Chapter 2 describes stereo implementation using PHIGS, 
and chapter 3 describes stereo implementation using ES/PSX. 
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2. PHIGS Stereo Implementation 



The ES V Workstation provides a method for creating stereo images through 
PHIGS. This method includes two separate "screens" in the X server, one for 
monoscopic applications and one for stereoscopic applications. Stereo 
screens are established with command line switches at the time the X server 
is started (See the man pages for Xesv, XGetScreenlnfo, 
XScreenWarpByCursor, XWarpToScreen, and csm.) 

The stereo application is responsible for setting up the stereoscopic fields 
in the view table and for opening the X connection to the stereo screen. 
Everything else is handled by the X server. 

Note: If you are using the mwm window manager, 
you must use the -multiscreen option on the 
command line when you start mwm. 

Interface Overview 

The ES V Workstation contains a special screen in the X server to support ste- 
reoscopic applications. The stereo application must open a window some- 
where in the "stereo screen" (host:0.x) where xis the screen number of a 
stereo screen. You toggle between screens by moving the cursor off the left 
or right side of the screen. 

The stereo screen is 512 pixels high. If PHIGS graphics are displayed in 
this window, the system will traverse the graphics structure twice to display 
both stereoscopic fields. 

Using the PHIGS Viewing Model for Stereo 

The stereo application must create the left-eye and right-eye stereoscopic 
fields in the PHIGS view table. These views are used by the system during tra- 
versal. To tell the system which stereoscopic field should be used for each 
eye, a PHIGS GSE is provided, which is an extension of the 
SET_VIEWJNDEX element. Rather than indicating a single index in the 
GSE, the application indicates three indices: one for left-eye, one for right- 
eye, and one for monoscopic viewing. 

The left-eye and right-eye views are established in the View Reference 
Coordinate (VRC) system in VRC coordinates, as shown in figure 2-1. Left 
and right are established by shifting the Projection Reference Point (PRP) off 
the VRC z-axis in the ^-direction. Note that the viewing frustum is created by 
passing planes through the PRP and the corners of the viewing window 
(which is a rectangle on the viewing plane). 
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The closer the PRP is to the viewing plane, the more severe the perspec- 
tive angle. The view window rectangle is specified by the window field in the 
Pview_ map3 structure that is passed to pevaLvlew_map„_matrlx3. 
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Figure 2-1. View reference coordinate system 

• The viewing plane coincides with the surface of the monitor screen, 
and the viewing window corresponds to the X window on the screen 
in which the graphics will be displayed. The following parameters 
should be carefully selected to create the best stereo image: 

• PRP z- value (the distance between eyes and the monitor screen), 

• The size of the X window in which the 3D object is drawn, 

• PRP x- value (the interocular separation). 

In the beginning of the example program in "Appendix B," you will see a 
constant, INCHESJTO_VRC, which allows you to map physical inches to 
VRC distances. It is critical that real inches are correctly converted to units of 
VRC space, so that the stereoscopic fields are correctly calculated. 

/* Stereo params in physical inches */ 

♦define EYE__TO_SCREEN 36.0 

#define WINDOW_SIZE 9.0 

#define VIEW__RATIO (EYE_JTO__SCREEN / WINDOW_S.IZE) 

/* Stereo params in VRC units */ 
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♦define VRC_WINDOW_SIZE 4.0 

♦define INCHES_TO_VRC (VRC_WINDOW_SIZE / WINDOW_SIZE) 

♦define VRC_PRP (EYE_TO__SCREEN * INCHES_TO_VRC) 

♦define HALFJDCCULAR (1.25 * INCHES_TO_VRC) 

Stereo Setup Procedure 

1. Create a stereo screen when starting the X server 

First, create a stereo screen to hold stereo applications. This is done by using 
special command line options when the X server is started. There are two op- 
tions you need to use; the -nscreens MxN option that creates an array of size 
M by N available screens, and the -stereoscr n option that indicates which of 
the screens are stereo screens. For example, if you start the X server directly, 
you could use 

% Xesv -nscreens 2x1 -stereoscr 1 
This creates two screens numbered and 1. Screen number 1 is a stereo 
screen. 

Or, if you start the X server with a call to xlnlt, the command is 

% xinit — ■ -nscreens 2x1 -stereoscr 1 

Many workstations use the xdm display manager. In this environment the 
command line options for the server are set in the /usr/lib/X1 1/xdm/Xservers 
file. There are many ways this can be done. (See the xdm man page for more 
details.) For example, 

unix:0.0 local /usr/bin/Xll/Xesv -nscreens 2x1 -stereoscr 1 

2. Start a window manager that supports multiple screens 

If you are using the mwm window manager, start it using the -multiscreen 
command line option. 

% mwm -multiscreen & 

This command should appear in your .xsession file if you are using xdm 
or in your .xlnltrc file if you are using xlnlt. See the mwm man page for more 
details. 

3. Start a screen manager to allow you to switch screens 

You will probably want to start up a multiscreen manager client that will al- 
low you to switch between the regular screen and the stereo screen if your ap- 
plication doesn't make use of XScreenWarpByCursor. (See the 
XScreenWarpByCursor man page for more details.). A simple screen man- 
ager is provided with the ESV 2.0 software, called csm. (See the csm man 
page for more details.) You may also want to put the following command in 
your .xsession or .xlnltrc file: 

% csm 
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4. Open a connection to the stereo screen 

The application must first open a connection to the stereo screen. This is done 
by opening screen host:0.x., where x is the screen number of a stereo screen. 
To find out which screens are stereo screens, make a call to the X extensions 
function XGetScreenslnfo. The display pointer that is returned with the con- 
nection is then used when creating the window that will hold the PHIGS work- 
station graphics. 

/* Open the stereo screen for stereo windows. */ 

stereoDisplayString = XDisplayString(dpy) ; 

strptr « rindex (stereoDisplayString, ':'); 

XGetScreenslnfo (dpy, &screen_info) ; 

numscreens = screen_info->numof screens; 

for (i=0; i<numscreens; i++) 

{ 
if (screen__info->screens [i] .screentype == xStereoScreen) 
{ 

sprintf( (strptr + 1), M 0.%d M , i) ; 
} 

} 

if (!(sdpy = XOpenDisplay (stereoDisplayString) )) 
{ 

perror ("Cannot open display for Stereo screen\n M ) ; 

exit(-l) ; 
} 

5. Open a window on the stereo screen 

Do this by creating the window with the stereo screen's display pointer. 

6. Open a PHIGS workstation for the stereo window 

For example, 

conn . drawable_id - stereo__win; 
popen_ws (stereo_wks, (Pconnid *) 

(&conn) , phigs_ws__type__x_drawable) ; 

7. Set up the left-eye and right-eye views 

Set up the PRPs (one for each eye) in conjunction with the viewing plane. The 
position of the viewing plane corresponds to the monitor screen. The z value 
of the PRP is the z-coordinate of the PRP in VRC space. This distance should 
directly correspond to the physical distance of your eyes from the screen. The 
application should translate physical distances into distances in VRC units. 
Create the left-eye and right-eye viewing matrices and put one each in the 
view tables of the left-eye and right-eye workstations. 
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/* left eye view */ 

mapping. pro j__ref_jpoint.x = -1.0 * half_occular_dist; 

peval__view_map__matrix3 (^mapping, &err, 

view_rep.map_matrix) ; 
pset_yiew__rep3 (stereo_wks, left__view_index, &view__rep) ; 

/* right eye view */ 

mapping. proj_refj?oint .x = half_occular_dist; 

peval__view_map_matrix3 (fimapping, &err, 

view_rep.map__matrix) ; 
pset_yiew__rep3 (stereq__wks, right_view_index, &view__rep) ; 

5. Put the GSE stereo view index element into the structure 

Put the GSE stereo view index element into the 3D structure that points to the 
stereo viewing matrices created in step 4. 

popen__struct (structure) ; 
pset_yiew_ind (stereo_yiew_index) ; 

6. Post the structure to the stereo workstation 

Post the structure to the stereo workstation to view the 3D object. 

ppost_struct (stereo__wks, structure, 0.0); 
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3. ES/PSX Stereo Implementation 



Selecting a Stereoscopic Model 

A stereoscopic viewing model defines a set of 4x4 viewing matrices, one for 
the left-eye view and one for the right-eye view. The graphics viewing trans- 
formations required to produce the proper stereoscopic view for each eye de- 
pend on the user's requirements. Most users prefer a "natural" viewing 
transformation model, where the image is computed as though it were etched 
on the screen by light rays passing through the screen on the way from a real 
object to the eye. This "natural" model is preferred because it takes full ad- 
vantage of the following depth cues to enhance the perception of stereopsis: 

• Perspective 

• Oblique angle display 

• Intensity cueing 

• Parallax 

The F:STEREO function implements the "natural" viewing transforma- 
tion model described above to take full advantage of the depth cues, and its 
use is strongly recommended. The F:STEREO function provides consider- 
able control by allowing the user to amplify or suppress any of the depth cues. 
For example, the F:STEREO function can produce an orthographic projec- 
tion for users' applications. Refer to the "Perspective vs. Orthographic Pro- 
jection" helpful hint for more details. 

The left-eye and right-eye 4x4 viewing matrices, generated by the 
F:STEREO function, are computed by sending the desired object viewing pa- 
rameters to the F:STEREO function in a way which includes the viewer and 
the screen as objects in the scene. These parameters include: 

• Viewport size, placement, and aspect ratio 

• Location of the viewer with respect to the viewport 

• Placement of the viewer's eyes on his face 

• Placement of the near and far clipping planes as though they were real 
objects in the room 

• A number to relate the size in data space to the size in room space 

The 4x4 viewing matrices can be generated by one of the commands in 
the following list. Only the F:STEREO function, or one of the other com- 
mands shown in the list, can be used to create the 4x4 viewing matrices. They 
must not be mixed in the display structure. 
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• F:STEREO function 

• EYEBACK command 

• FIELD_OF_VIEW command 

• MATRIX_4x4 command 

• WINDOW command 

If the F:STEREO function is not used, the "Helpful Hints for Implement- 
ing Stereoscopic Images" section contains guidelines for creating stereoscop- 
ic images. 
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The F:STEREO Function 
Type: 



Intrinsic User Function — - Miscellaneous 



(Face Position) 3D ► 

(Viewport Size) 2D- — — ► 

(Near Clip Plane) R- ► 

(Far Clip Plane) R ► 

(Interocular Space) R — — ► 

(Window Height) R — — * 

(Trigger) B- * 



RSTEREO 

<1>C 
<2>C 
<3>C 
<4>C 
<5>C 
<6>C 
<7> 



<1> 
<2> 



-* 4x4 (Left Eye) 
-> 4x4 (Right Eye) 



( 



Purpose: 



Description: 



This function produces the left-eye and right-eye matrices for stereoscopic 
display. 



Inputs 



<1> — The (x,y,z) position of the face of the viewer with respect 
to the origin, which is at the screen in the center of the 
viewport, z will be negative. 

<2> — The (x,y) dimensions of the viewport as measured on the 
screen. 

<3> — The distance from the screen to the near clipping plane. 
A negative number means the plane is positioned closer 
to the viewer than the screen. 



( 
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<4> — The distance from the screen to the far clipping plane. 
This number can also be negative, but must always be 
more positive than input <3>. 

<5> — The interocular separation of the viewer. This number is 
typically 2.5 in. (6.35 cm). 

<6> — This number represents the vertical height of the viewing 
pyramid-of- vision, in data-space units, at the origin (i.e., 
window height bottom-to-top). 

<7> — This input triggers the function. A Boolean true triggers 
a perspective stereoscopic view, and a Boolean false 
triggers an orthographic stereoscopic view. 

Outputs 

<1> — The 4x4 matrix describing the left-eye view. 
<2> — The 4x4 matrix describing the right-eye view. 



Notes: 



1) Inputs <1> through <5> are specified in room-space coordinates, such as 
inches or centimeters. Any measuring units are permitted, as long as con- 
sistency is maintained. Input <6> uses the coordinate system of the data 
base. 

2) Inputs <1> through <6> are constant input. Messages placed on them are 
remembered until replaced by new messages. After initial setup is com- 
pleted, these inputs can be adjusted. The function is then triggered by ei- 
ther a Boolean true for perspective view or a Boolean false for 
orthographic view on input <7>. 

Orthographic stereoscopic views (see input <7>) are not generally recom- 
mended, since the images they produce are in conflict with the stereopsis 
cues supplied in stereoscopic display. The natural perspective display for 
the user's viewpoint is computed automatically, based on the other inputs, 
when input <7> is a Boolean true. 

3) The outputs of this function typically connect to nodes of the 
MATRIX_4x4 type, which are placed in the left and right branches of a 
dual display structure. These branches also contain the viewport specifi- 
cation for the left-eye and right-eye viewports. After the eye viewport and 
viewing matrix are specified, the structure converges to draw the user's 
scene, being traversed once for each eye. 

4) For a single view, output <2> can be disconnected, and the interocular 
distance of input <5> set to zero. 
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Example: 

The following code is an example of a stereo implementation using the 
F:STEREO function. The STEREOJTRIGGER function is used to hold the 
Boolean true for perspective viewing from one firing to the next. 

STEREO_EYES :« F: STEREO; STEREO__TRIGGER :*= FrCONSTANT; 

CONN STEREOJ2YES <1> : <1> Left_eye_object .Mtx; 

{ 4x4 left eye view matrix } 

CONN STEREO__EYES <2> : <1> Right__eye_object e Mtx; 

{ 4x4 right eye view matrix } 

CONN STEREOJTRIGGER <1> : <7> STEREO_EYES; 

{ sets perspective & triggers} 

SEND V3D (0,0,-24) TO <1> STERE0_EYES; 

{ initialize face position } 

SEND V2D(ll f ll) TO <2> STEREO_EYES; 

{ initialize vp screen size } 

SEND -4.0 TO <3> STEREO_EYES; { near clipping plane } 

SEND 4.0 TO <4> STEREO_EYES; { far clipping plane } 

SEND 2.5 TO <5> STEREO__EYES; {recommended eye spacing } 

SEND 2.0 TO <6> STEREO_EYES; { viewing pyramid height } 

SEND TRUE TO <2> STEREOJTRIGGER; 

{ arm the trigger function for TRUE perspective } 

Developing a Stereoscopic Display Structure 

The left-eye and right-eye viewing matrices generated by the RSTEREO 
function or some other model must be incorporated into the stereoscopic dis- 
play structure. To understand this procedure, a discussion of a monoscopic 
display structure is presented first, followed by a discussion of the corre- 
sponding stereoscopic display structure. 

Most monoscopic display structures can easily be converted to stereo- 
scopic display structures. Examination of the parts of a monoscopic display 
structure will help in understanding the creation of a stereoscopic display 
structure. Figure 3-1 shows the parts of a typical monoscopic image display 
structure. 
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1. Begin Traversal 



2. Define Monoscopic Viewport 



3. Set Monoscopic Viewing Window 



4. Scene Transformations 



5. Draw the Object(s) 

Figure 3-1. Monoscopic image display structure 

The five parts of the display structure shown in figure 3-1 have the fol- 
lowing purposes: 

1) The root of the display structure 

2) Define the part of the screen on which the picture will be drawn 

3) Place the position of the viewer in the scene at the proper location 

4) Move the object(s) around to set the scene 

5) Define the shape of the object(s) 

Items 4 and 5 can be part of a complex structure, but items 1, 2, and 3 are 
usually a single node. 

The following describes the building of a model to display a cube. The 
parts of the display structure are outlined. The numbers correspond to 
figure 3- 1 . They are in reverse order because the structure is typically defined 
first at the leaves and finally down to the root. 

5. Draw the Object(s) 

Initially, the cube is defined at the origin. Two vector lists are created, each 
defining a square, and translated from the origin by one data-space unit in 
each direction. The corners are then connected. This is accomplished by the 
following commands: 
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Cube :=begin_structure 1 

Translate 0,0,1; 

Vector__list block connected n=5 

1,1 1,-1 -1,-1 -1,1 1,1; 

Translate 0,0,-2; 

VectorJList block connected n-5 

1,1 1,-1 -1,-1 -1,1 1,1; 

Translate 0,0,1; 

Vector_list block separate n=8 

-1,-1,-1 -1,-1,1 

-1, 1,-1 -1, 1,1 

1,-1,-1 1,-1,1 

1, 1,-1 1, 1,1; 
End_structure; 

4. Scene Transformations 

The cube defined in the previous step is scaled to quarter-size and randomly 
rotated. Also, near and far clipping are turned on. The names assigned to the 
nodes are chosen at random. This is accomplished by the following com- 
mands: 

Rot_x := rotate in x 30 then cube; 
Rot_y := rotate in y 10 then rot_x; 
Seal := scale 0.25 then rot__y; 
Klip := set depth__c lipping on then seal; 
World := instance of klip; 

3. Set Monoscopic Viewing Window 

The FIELD_OF_VIEW command is used to position the viewer for a mono- 
scopic view. This is accomplished by the following command: 

Mtx :« field_pf_yiew 30 front=-l back=l then world; 

2. Define Monoscopic Viewport 

For simplicity, a unity viewport is specified. This is accomplished by the fol- 
lowing command: 

Vp := viewport horizontal--! :1 vertical=-l:l intensity=0 : 1 
then mtx; 

1. Begin Traversal 

Displaying the monoscopic image is accomplished by the following com- 
mand: 

Display Vp; 



C 



( 
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For the stereoscopic view, a separate view for each eye is required. Figure 
3-2 shows the corresponding stereoscopic display structure. Steps 5 and 4 are 
the same as in the monoscopic view, since the same scene is being viewed 
with both eyes. The structure is a directed graph, meaning that two or more 
branches are permitted to grow back together to arrive at the same leaf node. 

It is necessary to specify different y values for the left and right viewports. 
The ES V Workstation stereoscopic timing format will cause the left and right 
viewport images to appear in the same viewing region of the screen. 

1. Begin Traversal 



(Go Left, Then Right) 



2a. Define Left 
Stereoscopic Viewport 



3a. Set Left 
Viewing Matrix 



2a. Define Right 
Stereoscopic Viewport 



3a. Set Right 
Viewing Matrix 



4. Scene Transformations 

5. Draw the Object(s) 

Figure 3-2. Stereoscopic image display structure 

5. Draw the Object(s) 

Initially, the cube is defined at the origin. Two vector lists are created, each 
defining a square, and translated from the origin by one data-space unit in 
each direction. The corners are then connected. This is accomplished by the 
following commands: 
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Cube r^begin^structure 

Translate 0,0,1; 

Vector_list block connected n=5 

1,1 1,-1 -1,-1 -1,1 1,1; 

Translate 0,0,-2; 

Vector_list block connected n=5 

1,1 1,-1 -1,-1 -1,1 1,1; 

Translate 0,0,1; 

Vector__list block separate n=8 

-1,-1,-1 -1,-1,1 

-1, 1,-1 -1, 1,1 

1,-1,-1 1,-1,1 

1, 1,-1 1, 1,1; 
End_st met ure; 

4. Scene Transformations 

The cube defined in the previous step is scaled to quarter-size and randomly 
rotated. Also, near and far clipping are turned on. The names assigned to the 
nodes are chosen at random. This is accomplished by the following com- 
mands: 

Rot_x i- rotate in x 30 then cube; 
Rot__y := rotate in y 10 then rot_x; 
Seal := scale 0.25 then rot_y; 
Klip := set depth_c lipping on then seal; 
World := instance of klip; 

3a. Set Left Viewing Matrix 

Since the left eye needs to be specified as being slightly off-axis from the 
viewport center, none of the standard eye-position routines (such as 
FIELD_OF_VIEW) can be used with accuracy. Instead, the F:STEREO func- 
tion is used to generate the left-eye matrix. This matrix is supplied to the 
structure by the following commands: 

STER := F : STEREO; 

CONN STER <1> : <1> Mtx_left; 

The following values are sent to the F:STEREO function, and the function 
generates a matrix to set the left object viewing area: 

• The face of the viewer is 24 inches back from the screen, centered in 
front of the viewport. 

• The viewport size is 14 inches wide by 1 1 inches high (full-screen). 
9 The clipping planes are set at 7 inches before and behind the screen. 

• The left eye of the viewer is 1.25 inches to the left (*.£., the viewer's 
interocular separation is 2.5 inches). 
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• The viewing aperture is 2 data units high at the screen, which also 
contains the origin at the center of the viewport 

All of the above variables are input to the F:STEREO function and can be 
changed, depending on the model. Setting an initial left viewing matrix is ac- 
complished by the following commands: 

Mtx__left := matrix__4x4 

.60829, 0, 0,0 

0, .77419, 0, 

-.03168, 0, -.21544, * *177M2. 

0, 0, .27419, .77419 then world; 

3b. Set Right Viewing Matrix 

The right-eye position matrix is the same as left-eye, except that the right eye 
of the viewer is 1.25 inches to the right. Setting an initial right viewing matrix 
is accomplished by the following commands: 



Mtx_right := 


matrix 4x4 






.60829, 


o, 


o, 





o, 


.77419, 


0, 





.03168, 


0, 


-.21544, 


.17742 


0, 


0, 


.27419, 


.77419 



then world; 

The F:STEREO function is used to generate the right-eye matrix. This 
matrix is supplied to the structure by the following command: 

CONN STER <2> : <1> Mtxjcight; 

2a. and 2b. Define Left and Right Stereoscopic Viewports 

Each master stereoscopic viewport provides optimal stereoscopic viewing on 
the ES V Workstation. The master stereoscopic viewport determines the part 
of the screen that is available for stereoscopic viewing and the eye that sees 
it. These viewports are defined by the following commands: 

left_vp : = viewport horizontal=-l:l 

verticals 00390625: .99609375 intensity=l:l; 

rightjvp := viewport horizontal=-l : 1 

vertical=-. 99609375:-. 00390625 intensity-l:l; 

These horizontal, vertical, and intensity values should be used exactly as 
shown in any stereoscopic application program. Dividing the screen into 
menu viewports and object display viewports can be done after the master 
viewports are defined. The ES V Workstation stereoscopic timing format will 
cause the left and right viewport images to appear in the same region of the 
screen. 
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1. Begin Traversal 

Displaying the data structure and dividing the trunk into two branches is ac- 



complished by the following commands: 

Trunk : = instance of vp_JLeft, vp__right; 
Display trunk; 



Stereoscopic Viewports 



The first element of the left branch of the stereoscopic data structure should 
be the master stereoscopic viewport for the left-eye view, defined as follows: 

left__vp :- viewport horiz** —1:1 

vert= .00390625 : .99609375 intens - 1:1; 

Similarly, the first element of the right branch of the stereoscopic data 
structure should be the master stereoscopic viewport for the right-eye view, 
defined as follows: 

right_vp :- viewport horiz= -1:1 

vert= -.99609375: -.00390625 intens= 1:1; 

Once the master stereoscopic viewports for the left-eye and right-eye 
branches are defined, the object and menu viewports can be defined below 
them with any shape, size, or intensity. All subsequent viewports can be de- 
fined as they would be in a monoscopic structure. Objects which are to be dis- 
played for both eyes must be instanced under both the left-eye and right-eye 
master viewports. 

The following code shows the implementation of viewports for the object 
display area. Note that the intensity is specified using the SET INTENSITY 
command. 

SEND 'GO' TO <1> STEREO_CONFIG$; 

{ trigger the system stereo config } 



Leftist ereo__view := begin__s 

{ use this vp definition as is } 
LEFT_VP := VIEWPORT HORIZ= -1:1 

VERT= .00390625 : .99609375 INTENS - 1:1; 
INST STEREO_PICK_CONFIG; 

{ stereo pick location and cursor config} 
inst Left_eye_object; 

{ left eye object display structure } 

end_js ; 

Right_stereo_yiew := begin_s 

{ use this vp definition as is } 
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RIGHT_VP := VIEWPORT HORIZ= -1:1 

VERT= -.99609375 : -.00390625 INTENS= 1:1; 

inst Right__eye_object; 

{ right eye object display structure } 

end_s ; 

Left__eye_object := begin_s 

Clip : = set depth_c lipping off; 

{ fkeys network input point } 
viewport horiz = -.8 : .8 vert = -1:1; 

{ use any desired values } 
set intensity on 0:1; 

border__color := set color 120,. 4 then border; 
{ F: STEREO function input point. Correct stereo values will 

be supplied to the matrix when the STEREO__EYES function 

is triggered } 
Mtx := matrix__4x4 1,0,0,0 
0,1,0,0 
0,0,1,0 
0,0,0,1; 



end_s ; 

Right_eye__object := begin_s 

Clip : = set depth_c lipping off; 

{ fkeys network input point } 
viewport horiz = -.8 : .8 vert == -1:1; 
set intensity on 0:1; 

border_color := set color 120,. 4 then border; 
{ F: STEREO function input point. Correct stereo values will 

be supplied to the matrix when the STEREO_EYES function 

is triggered } 
Mtx :« matrix_4x4 1,0,0,0 
0,1,0,0 
0,0,1,0 
0,0,0,1; 



end_s ; 

Items such as menu text and borders, which will not be displayed with ste- 
reoscopic separation, can be defined in both the left-eye and right-eye branch- 
es or, optionally, they can be defined in only one branch. If a menu is defined 
only in the left branch, it will be visible only to the left eye. This can be a de- 
sirable effect, depending on the viewer preference. Items which are to be dis- 
played for both eyes with no stereoscopic separation should be instanced 



Stereo User's Manual [2.0] 3-11 



ES/PSX Stereo Implementation 



below the master viewport LEFT_VP or RIGHT_VP but above the 
F:STEREO matrix. The border in the previous code example is used in this 
way. 

Picking Implementation 

Stereoscopic application programs which implement picking must reconfig- 
ure the ES V Workstation system pick location and cursor definitions. This is 
accomplished by issuing the following command when the program enters 
the stereoscopic viewing mode: 

send 'go' to <l>stereo_config$; 

This command reconfigures the ES V Workstation to provide a tablet- 
driven cursor which picks accurately on both menu items and 3D stereoscopic 
objects. It also configures the correct system viewport and stereoscopic tim- 
ing format. 

An application program uses the new picking/cursor configuration by de- 
claring a single instance of STEREO_PICK_CONFIG immediately after the 
LEFT_STEREO_VIEWPORT definition. Picking accuracy for 3D objects is 
achieved by restricting the cursor and locations that can be picked to the left 
branch of the stereoscopic structure. The PICK IDENTIFIERS and 
SET PICKING ON nodes in the left branch are the only ones that will ever ac- 
tually result in a pick. Those on the right branch will have no effect since the 
cursor can never reach the locations in the right branch. The following exam- 
ple shows picking implementation for the FKEY menus. 

SEND 'GO' TO <1> STEREO__CONFIG$; 

{ trigger the system stereo config } 



Left__stereo__view : = begin_s 
LEFT_VP := VIEWPORT HORIZ= -1:1 

VERT- .00390625 : .99609375 INTENS = 1:1; 
INST STEREO__PICK__CONFIG; 

{ stereo pick location and cursor config} 
inst Left_eye_object; 

{ left eye object display structure - pickable} 
inst fkey__menu; { left eye on screen menu - pickable } 

end__s ; 

Right_stereo_view :« begin_s 

RIGHT_VP := VIEWPORT HORIZ= -1:1 

VERT= -.99609375 : -.00390625 INTENS= 1:1; 
inst Right__eye__object; 

{ right eye object display structure - pickable} 
inst fkey_menu; { right eye on screen menu - not pickable} 
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end__s ; 

fkey__menu :~ begin_s 

menu_vp := view horiz= -1.0: -.8 5 vert= -1:1; 

{ can use any values } 
character scale .25, .05; 

if bit 4 on; { don't display if menus off } 

inst menu__outline; 
set pick identifier^ menu_labels ; 

set picking on; { picks on left branch only } 

inst fkey__labels; 
end s; 



Cursor Implementation 



The stereoscopic system cursor defined by STEREO_CONFIG$ is a white X 
with an open green box at its center. Picking is accomplished by aligning the 
point and the open box. This cursor makes picking easier for stereoscopic ob- 
jects, particularly objects with a large z-translation. Picking on 3D stereo- 
scopic objects will be accurate as long as the point being picked can be 
visually distinguished from surrounding points. 

The shape and color of the stereoscopic cursor can be modified by the ap- 
plication program with some cautions and restrictions. Changes made to the 
stereoscopic cursor definition will be permanent until the system is rebooted, 
as long as the names in the system cursor structure are not redefined to in- 
stance user's structure names. If a system cursor name is redefined to instance 
a structure with a user's name, those parts of the cursor will be subject to ini- 
tialization commands, which can result in some or all of the stereoscopic cur- 
sor definition being lost. For example, the stereoscopic system cursor is 
defined as follows: 

configure a; 

STCURSOR1 := set inten on 1 : 1 then STCURSOR_PARTSl; 
STCURSOR_PARTSl := inst STCURSOR__CROSSl, STCURSOR_SQUAREl; 
STCURSOR_CROSSl :- set color 0,0 then STC_CR0SS_VECS1; 
STCURSOR_SQUAREl := set color 240, .8 then STC_SQUARE_VECS1; 
STC_SQUARE__VECSl:=vec n=5 -.015, -.015 -.015,. 015 .015, .015 

.015, -.015 -. 015, -.015; 
STC_CROSS_VECSl:=vec sep n=5 -.035, -.035 -.015,-. 015 

.015,. 015 .035,. 035 .035, -.035 . 015,-. 015 -.015, . 015 - 

.035, .035; 
SEND V2D(.015, .015) TO <2> STEREO_PICK_LOCATION$l; 
finish configuration; 
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An application can safely and permanently change the outline of the 
square center box to full intensity red by entering the following command: 

STCURSOR_SQUARE :- SET COLOR 120,1 THEN STC_SQUARE_VECS; 

This change to the stereoscopic system cursor will be retained until it is 
redefined, or the system is rebooted. This will be true even if the system is 
switched in and out of the stereoscopic viewing mode. 

If an application redefines the stereoscopic cursor color as follows: 

STCURSOR_SQUARE :- INST MY_USER_COLOR; 

MY_USER__COLOR := SET COLOR 120,1 THEN STC_SQUARE_VECS ; 

then any initialization command would destroy MYJJSER_COLOR, leav- 
ing: 

ST__CURSOR__SQUARE := NIL; 

A third party application that modifies the stereoscopic cursor should rec- 
reate its original definition before terminating. 

When an application program exits from the stereoscopic viewing mode, 
the following command should be entered to restore the system to the normal 
monoscopic cursor and picking: 

send 'go' to <l>restore_config$; 

The Stereo Viewing Option supports only the update rate cursor. 

Configuring the ESV Workstation for Stereoscopic Viewing 

The default stereo network and display structure discussed here are contained 
in the configuration file stcfg.dat, which, if in the ES/PSX configuration di- 
rectory, are read at start-up time. 

The first step in viewing a stereoscopic image is to put the ESV Worksta- 
tion into the stereoscopic viewing mode. This is accomplished by entering the 
following command: 

send 'go' to <l>stereo__config$; 

This command causes the ESV Workstation system configuration to 
change from the monoscopic viewing mode to the stereoscopic viewing 
mode. The system reconfiguration includes the following steps: 

• Enlarging the size of the system viewport VPF1 $, so that the full 
screen is available for stereoscopic viewing, 

• Setting the correct stereoscopic timing format for the PS390ENV 
function, 

• Restructuring the system definitions of the pick location and cursor. 



c 



c 



c 
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In the stereoscopic viewing mode, the text on the terminal emulator will 
become larger, and it will appear bright only to the right eye when the viewing 
glasses are worn and the device controller is turned on. If the bright image is 
in the left eye, the stereoscopic mode must be reversed by toggling the 
STEREO/PSEUDO switch on the device controller. 

To return to the monoscopic viewing mode, enter the following com- 
mand: 

send 'go' to <l>restore_config$; 

Alternative System Configuration 

Some applications do not require the stereoscopic cursor and picking. The 
following set of commands can be used in place of the STEREO_CONFIG$ 
and RESTORE_CONFIG$ functions to set up the system viewport and timing 
format. To enter the stereoscopic viewing mode, enter the following com- 
mands: 

configure a; 

send m2d(-. 997 , .997 -1,1) to <l>vpfl$; 

finish configuration; 

send fix (2) to <5>ps390env; 

{ "fix (3)" may be used for special low-precision stereo- 
scopic mode. } 

send true to <l>ps390env; 

These commands must be executed as a single file. They set the ESV 
Workstation system viewport so that the full screen is available for stereo- 
scopic viewing, and they set the ESV Workstation timing format to merge the 
left-eye and right-eye views into a single, full-screen stereoscopic image. 
Note the alternative, low-precision format available. This format provides the 
same resolution in both the x and y directions. 

To return to the monoscopic viewing mode, enter the following com- 
mands: 

configure a; 

sendm2d(-l,l -1,1) to <l>vpfl$; 

finish configuration; 

send fix(O) to <5>ps390env; 

send true to <l>ps390env; 
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Helpful Hints for ES/PSX Stereo Implementation 

Toggling Between Monoscopic and Stereoscopic Viewing Modes 

Enter the following command to go from the stereoscopic viewing mode to 
the monoscopic viewing mode: 

send r go f to <l>restore__config$; 

Enter the following command to go from the monoscopic viewing mode 
to the stereoscopic viewing mode: 

send 'go' to <l>stereo_config$; 

These commands insure that the proper timing format is sent to input <5> 
of the PS390ENV function, and they also activate the stereoscopic picking 
and cursor configuration. 

Update Rate Cursor 

The stereoscopic system cursor is an update rate cursor. The monoscopic sys- 
tem default cursor is also an update rate cursor. The stereoscopic viewing 
configuration does not support refresh rate cursors, sometimes called hard- 
ware cursors. 

If an application uses the refresh rate cursor, the system must be returned 
to the update rate cursor before entering the stereoscopic viewing mode. Enter 
the following commands to restore the update rate cursor: 

send fix(O) to <4>ps390env; 
send true to <l>ps390env; 

Line Resolution in Stereo 

Images on the ES V Workstation are normally displayed with a screen resolu- 
tion of 1024 horizontal scanlines, each containing 1280 pixels. This provides 
a picture with an aspect ratio of 5:4. 

In stereoscopic mode, only half the scanlines are seen by the left eye, and 
the other scanlines are seen by the right eye. This effectively halves the screen 
resolution in the vertical axis, while maintaining the full resolution in the hor- 
izontal axis. Since a pixel is now effectively twice as high as it is wide, lines 
drawn with angles near the horizontal tend to appear thicker, while near- ver- 
tical lines remain crisp. 

While most users prefer to maintain the high resolution in the horizontal 
axis wherever possible, some users require that lines at all angles be drawn 
with constant thickness, even though this means giving up available horizon- 
tal resolution. For these users, a special uniform-resolution stereoscopic for- 
mat is provided, which consists of only 640 pixels along the horizontal axis. 
It may be invoked as follows. 
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1) For stereo commands involving the STEREO_CONFIG$ function, a vari- 
able called STEREO_KIND$ is provided. It contains a default value of 2, 
which selects mixed-resolution stereo. It must be modified before invok- 
ing the STEREO_CONFIG$ function, as follows. 

• For uniform-resolution stereo, enter the following commands: 

store fix (3) in stereo_kind$; 
send 'go' to <l>stereo_config$; 

• To return to mixed-resolution stereo, enter the following commands: 

store fix (2) in stereo_kind$ ; 
send 'go' to <l>stereo__config$; 

• The user who wishes to change between the two stereo modes must 
first return to monoscopic mode by entering the following command: 

send 'go' to <l>restore_config$; 

Since STEREO_KIND$ is a variable, it will remember its value. Thus, the 
above STORE commands need only be executed once. 

2) For users controlling stereo operations by means of the PS390 EN V initial 
function instance (see "Alternative System Configuration"), the follow- 
ing changes apply. 

• For uniform-resolution stereo, enter the following commands: 

send fix (3) to <5>ps390env; 
send true to <l>ps390env; 

• For mixed-resolution stereo, enter the following commands: 

send fix (2) to <5>ps390env; 
send true to <l>ps390env; 

• To switch between stereo resolutions, first return to the monoscopic 
mode by entering the following commands: 

send fix(O) to <5>ps390env; 
send true to <l>ps390env; 

Image Distortion 

If an image is distorted in one direction, the incorrect viewport size measure- 
ments, clipping plane values, or window height are being sent to the 
F:STEREO function. Refer to the "Clipping Planes" and "Object Viewing 
Region" helpful hints for information about converting data space coordi- 
nates to the room space units needed for input to the F:STEREO function. 
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Depth Cues 

Special applications may require adjusting or even deleting one or more of the 
following depth cues: 

• Perspective 

• Oblique angle display 

• Intensity cueing 

• Parallax 

For example, in some modeling applications, measurements must be 
made using the tablet and cursor. Because perspective will foreshorten di- 
mensions with depth, making them invalid for these applications, an ortho- 
graphic image must be selected while measurements are made, even though 
the view will be distorted. Sending a Boolean false to input <7> of the 
F:STEREO function will produce an orthographic view. 

Adjusting Perspective 

Since perspective is determined by the geometry of the screen and the user's 
eyes, the amount of perspective effect can be changed by multiplying both the 
inter-eye spacing value of F:STEREO input <5> and the elements of the 
viewer position vector on input <1> by a constant. 

For example, doubling both the z-distance of the user from the screen and 
the interocular spacing reduces the perspective of the image to half of its 
former value. 

Perspective vs. Orthographic Projection 

Most applications which use orthographic projections for the monoscopic 
viewing mode should use the F:STEREO function perspective view for the 
stereoscopic viewing mode. Many monoscopic applications use an ortho- 
graphic projection to prevent distortions in relative object size. The perspec- 
tive view generated by the F:STEREO function does not produce distortions 
in apparent object size as the object is moved toward the viewer. An ortho- 
graphic view in the stereoscopic viewing mode can appear distorted to the 
viewer, since the eye-brain system expects perspective depth cues when look- 
ing at 3D objects. 



Ghosting 



Ghost lines are caused by the blending of the left-eye and right-eye images on 
the liquid crystal shutter, and they can be a problem to users. The eye-brain 
system can be trained to ignore ghost lines when they are near enough to the 
real line that they are not confused with another, unrelated, line. However, in 
a very dense picture this can be impossible. 
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To alleviate the problem, the parallax cue can be reduced, causing the 
ghost lines to move toward their visible counterparts. This is done on input 
<5> of the F:STEREO function by specifying a smaller number for the in- 
terocular spacing. The effect is to reduce the stereopsis in the image, so that 
its volume seems to decrease, while leaving perspective untouched. Although 
artificial, it can be a good compromise between ghosting and no stereoscopic 
effect. 

Use darker backgrounds to increase the dynamic range. Since ghosting is 
color dependent, use red whenever possible and avoid using white. 

Clipping Planes 

Placement of the clipping planes in room space can be made directly as inputs 
to the F:STEREO function. To place these planes in data space, the user 
should remember that there is a ratio between the viewport height in data 
space, input <6> of the F:STEREO function, and the same measurement in 
room space, the y-component of input <2>. Remembering this ratio permits 
the conversion of any position value, including clipping planes, between 
room space and data space. 

For example, consider the following data: 

• 20 cm = room space viewport height (y-component of input <2>) 

• 2 units = data space window height (input <6>) 

• -1.2 units = data space near plane z-position (input <3>) 

• 2.5 units = data space far plane z-position (input <4>) 
First, find the ratio of room space to data units: 

20 cm room space 
ratio = — — = 10 cm of room space per data space unit 

2 units data space 

Next compute the room space clipping plane values which correspond to 
the -1.2 and 2.5 data space inputs to the F:STEREO function: 

near clipping plane cm ofwom space = 

-12 unit Sdata space * ratio = -12 cm room space 
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far clipping plane cm ofwom space = 

25 unit Sdata space * ratio = 25 cm room space 



When the room space clipping plane coordinates are known, rearrange the 
equation to compute the correct data space coordinates for the input to the 
F:STEREO function: 



near clipping plane dataspace ^ 



near clipping plane wom space 



ratio 



far clipping plan edataspace = 



far clipping plane womspace 



ratio 



When using the FrSTEREO viewing model, the near clipping plane 
should not go beyond the eye point. If the eye point is set at 60 cm from the 
screen, then the near clipping plane cannot be less than -60 cm (room space). 

Object Viewing Region 

The visible region of data space produced by the WINDOW command can be 
positioned anywhere with relation to the object, while the visible region of 
data space produced by the FrSTEREO function viewing matrix is always 
centered about the origin. The FrSTEREO viewing region can be modified by 
including a translation node in the display structure where it joins after the 
left-eye and right-eye branches. 

The x and y values at the point of the translation should be the average of 
the left and right (for x) and the bottom and top (for y) boundaries of the cor- 
responding WINDOW command. 

The values for the translation (x T , yj) can be computed from the average 
of the boundaries for the corresponding WINDOW command as follows: 



3"r=- 



X W(ty*) + X W(rfefe) 
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*r = - 



y W(bottom) + V Wtop) 



For example, assume that a square window is desired, ranging from 300 
to 700 in x, and from to 400 in y. Input <6> of F:STEREO (window height) 
would be 400, input <2> of F:STEREO, the viewport size measured at the 
screen, would be square, and the translation node at the joining of the left-eye 
and right-eye branches of the structure would contain the vector 
(-500,-200,0), where -500 is the negative x-average of 300 and 700, and -200 
is the negative y-average of and 400. 



Registration 



The left-eye and right-eye views in a stereoscopic model are registered when 
they appear to be exacdy superimposed on each other at the plane of the 
screen. If the F:STEREO function is used with the correct left-eye and right- 
eye viewports, the views will be registered. 

In some stereoscopic models not using the F:STEREO function, registra- 
tion can be a problem. In this case, the left-eye and right-eye views are hori- 
zontally shifted with respect to each other. This usually occurs when one of 
the viewports is moved in x with respect to the other, creating the problem of 
misaligned horizontal clipping. The images involved are usually orthographic 
rather than perspective. 



Stereo in the X Environment 



When stereo mode is entered, all other X windows are obscured by the stereo 
window. ES/PSX will grab the X pointer device to prevent it from remaining 
within some other window. If the keyboard and any other device focus is fol- 
lowing the pointer, those devices will be focused on the stereo window. 

If the keyboard and/or other devices have been explicitly focused in an- 
other window by a window manager, it is advisable to request ES/PSX to grab 
these other devices also so that they will not be inadvertently unavailable 
when entering stereo mode. ES/PSX can be instructed to grab all devices 
when entering stereo mode by specifying the following in an X defaults file: 

. . .main.stereoGrab: on 

You can also grab all devices by entering -stereoGrab on the command 
line. 
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Note: The only way that keyboard focus may be 

forced to remain in a window from which you 
are typing commands to ES/PSX is to 
explicitly focus the keyboard within the 
window before going into stereo mode. 
However, this will likely make the keyboard 
unavailable for use within the stereo window. 

Emergency Exit from Stereoscopic Viewing Mode 

During program development, users may find themselves switching into the 
stereoscopic viewing mode without providing a means to switch back to the 
monoscopic viewing mode. This generally happens because the entire screen 
is allocated for display of the stereoscopic image when switching to the ste- 
reoscopic viewing mode, thus obscuring all other windows. The pointer is 
grabbed by the stereo window rather than remaining in any other window it 
may have previously been in. 

ES/PSX may be forced out of the stereoscopic viewing mode in all cases 
by the following escape sequence. While holding down the CONTROL and 
SHIFT keys on the ESV Workstation keyboard, simultaneously press buttons 
1 , 2, and 3 on the mouse. ES/PSX will switch back to the monoscopic viewing 
mode, and a value of fix(O) will be sent to input <5> of the function instance 
PS390ENV, to prevent that function from inadvertently entering the stereo- 
scopic viewing mode when activated for other purposes. If the stereoscopic 
viewing mode was initially entered via the STEREO_CONFIG$ function, the 
cursor must still be restored to its proper form and range by the following 
command: 

send true to <l>restore__config$; 

Helpful Hints for Viewing Stereoscopic Images 
Lighting 

The QystalEyes stereoscopic viewing device is designed to work best in low 
light conditions. Fluorescent light is detrimental to the quality of the picture. 
The frequency of the fluorescent light can cause some flickering that will not 
be seen when using incandescent light. 

Viewing Angle 

The stereoscopic effect can be lost if the viewing angle is too great. A large 
viewing angle will also reduce the dynamic range. 



c 



c 



c 
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accommodation. The focusing of the image of an object on the retina by one 
eye. This process is controlled by a different set of muscles than the process 
of convergence. See also convergence. 

convergence. The focusing of both eyes on the same point of an object. This 
process is controlled by a different set of muscles than the process of 
accommodation. See also accommodation 

depth cue. An operation that imparts the illusion of depth to an image. Depth 
cues allow a user to perceive 3D on a 2D screen. 

disparity. The lateral displacement of an object's image on the screen which 
is produced because the eyes view the object from two different viewpoints. 
When viewing an object at infinite distance, the disparity is equal to the 
interocular separation. When viewing an object at the screen, the disparity is 
equal to zero. See also parallax. 

dynamic range. A measure of the relative luminance of an information 
element when transmitted by the stereoscopic viewing device in its 
transmissive state, and when blocked by the stereoscopic viewing device in 
its occluding state. The formula and methodology employed to determine the 
dynamic range is as follows: 

intensity through open shutter 
dynamic range = 



intensity through closed shutter 



ghosting. The blending of left-eye and right-eye images on the liquid crystal 
shutter due to the transition time between the transmissive and occluding 
states of the shutter. 

interocular separation. The separation between the eyes. This distance is 
approximately 2-1/2 inches, but varies between individuals. 

parallax. The apparent change in the direction of an object when viewed from 
two different viewpoints. When viewing an object at an infinite distance, the 
parallax is equal to zero. See also disparity. 

stereoscopic field. A view of a picture from the perspective of one eye. 

stereopsis. The process which occurs in the brain where two 2D images are 
combined to form one 3D image. 

stereoscopy. The science of viewing in three dimensions. 

viewing angle. The angle at the apex of the viewing pyramid (eye point of the 
viewer) used to define a perspective viewing area. 
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B. PHIGS Stereo Example Program 



This program can be found in /usr/people/fstest/demo/stereo_demo.c 

* stereo__demo . c 
* 

* A Canonical Stereo Program to prototype stereo on ESV f release 2.0 

* 

#include <stdio.h> 

#include <ermo.h> 

#include <string.h> 

♦include <X11/Xlib.h> 

♦include <Xll/Xatom.h> 

♦include <phigs/phigs .h> 

♦include <phigs/esgdp.h> 

♦include <extensions/XMultiScreen.h> 

♦include <extensions/XInput .h> 

extern int errno; 

char *ProgramName; 

♦define BLACK 
♦define WHITE 1 
♦define RED 2 
♦define GREEN 3 
♦define BLUE 4 
♦define YELLOW 5 
♦define CYAN 6 
♦define MAGENTA 7 

/* Stereo params in physical inches */ 
♦define EYE__TO_SCREEN 36.0 
♦define WINDOW_SIZE 9.0 
♦define VIEW_RATIO (EYE_TO_SCREEN / WINDOW__SIZE) 

/* Stereo params in VRC units */ 
♦define VRC_WINDOW_SIZE 4.0 

♦define INCHES__TO_VRC (VRC__WINDOW__SIZE / WINDOW__SIZE) 
♦define VRC_PRP (EYE_TO__SCREEN * INCHES_TO_VRC) 

♦define HALFJDCCULAR (1.25 * INCHESJTO_VRC) 
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♦define XROT_DIAL 
♦define YR0T__DIAL 
♦define ZROTJDIAL 
♦define SCALE_piAL 
♦define XTRAN_DIAL 
♦define YTRAN_DIAL 
♦define ZTRAN_DIAL 
♦define DIALSCALE 
♦define MAXDIALS 
♦define CHARS__PER_DIAL 
♦define SPACEKEYSYM 



/* Dial handling */ 



1 

2 

3 

4 

5 

6 

330.0 

8 

8 

32 



C 



♦define FRONT_BOTTOM__LEFT 
♦define FRONT_BOTTOM_RIGHT 
♦define FRONT_TOP_JLEFT 
♦define FRONT_TOP__RIGHT 
♦define BACK_BOTTOM__LEFT 
♦define BACKJBOTTOM_RIGHT 
♦define BACK_TOP_LEFT 
♦define BACK TOP RIGHT 



{-0.5, -0.5, 0.5} 

{ 0.5, -0.5, 0.5} 

0.5, 0.5} 

0.5, 0.5} 

0.5, -0.5} 

0.5, -0.5} 

0.5, -0.5} 

0.5, -0.5} 



{-0 
{ 
{»0 
{ 
{-0.5, 
{ 0.5, 



.5, 
.5, 
.5, 
.5, 



( 



♦define FRONT 
♦define BACK 
♦define LEFT 
♦define RIGHT 
♦define TOP 
♦define BOTTOM 



♦define MONO 
♦define STEREO 
int 



{ FRONT__TOP_RIGHT, FRONT_TOP__LEFT , \ 

FRONT__BOTTOM__LEFT , FRONT__BOTTOM_RIGHT } 
{ BACK_TOP__LEFT, BACK__TOP__RIGHT, \ 

BACK_BOTTOM__RIGHT, BACK_BOTTOM__LEFT } 
{ FRONT_TOP__LEFT, BACK_TOP__LEFT, \ 

BACK_BOTTOM_LEFT, FRONT JBOTTOM__LEFT } 
{ FRONT_TOP__RIGHT, FRONTJ30TTOMJRIGHT, \ 

BACK__BOTTOM_RIGHT , BACKJTOP_RIGHT } 
{ FRONT_TOP__RIGHT, BACK__TOP_RXGHT , \ 

BACK__TOP__LEFT , FRONT_TOP__LEFT } 

{ FRONT_BOTTOM_RIGHT, FRONTJBOTTOM_LEFT , \ 

BACK_BOTTOM_LEFT , BACK_BOTTOM_RIGHT } 

/* Flags for current video state */ 



mode_flag 



MONO; 



static Ppoint3 cube[6][4] = { FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM }; 
Pint mono__wks = 1; 

Pint stereo__wks = 2; 



C 
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Pint 

Pint 

Pint 

Pint 

Pfloat 

Pint 

int 

int 

Window 

Display 

GContext 

GC 

int 

float 

Pfloat 



structure = 1; 

mono__view_index = 1 ; 

left_view_index =1; 

right_view_index = 2; 

priority = 1.0; 

rotate__elem f trans late__elem; 

winx, winy, winw, winh; 

mono_winx, mono__winy, mono__winw, mono__winh; 

mono_win, mono__rootwin, stereo_win, stereo_rootwin; 

*dpy, *sdpy; 

gc; 

gc_black; 

text_x, text_y; 

h__to__w_aspect ; 

half__occular dist = HALF OCCULAR; 



XDevice 
XID 

XDevice 
XID 



*tablet 
tablet__id 
*dials 
dials id 



XDevicelnfo *devices 



/* Globals for device input stuff */ 
= NULL; 
= 0; 
= NULL; 
= 0; 
= NULL; 
= 0; 
■= -1; 



mt ndevices 

int DeviceMotion 

int DevicePress = -1 

int DeviceRelease = -1 

int change [10]; 

PmatrixS xrotmat, yrotmat, zrotmat, scalemat, concatl, concat2, 

concatS; 
Pmatrix3 currmatrix, tranmatrix; 
Pview_map3 mapping; 
Pview__rep3 view__rep; 
int mono_fd f stereo_fd; 

Window XCreateWindowO °, 



/•••a**************************** ^ 
* 

* identity_matrix 
• 

* Make an identity matrix. 
* 

****************************************************** 
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void identity_matrix( matrixit ) 

Pmatrix3 matrixit; 
{ 

int i, j; 

for ( i = ; i < 4 ; i++) 
{ 

for ( j = ; j < 4 ; j ++ ) 
{ 

if (i — j ) 

matrixit [i] [j] = 1.0; 
else 

matrixit [i] [j] - 0.0; 
} 
} 
} /* End of identityjmatrix */ 



/**********•************************•************************************ 
* 

* usage 
* 
•••••••••••••a*********************************************************/ 

usage () 
{ 

fprintf (stderr, "usage: %s [-options . . . ] \n\n", ProgramName) ; 

fprintf (stderr, "where options include:\n") ; 

fprintf (stderr, " -display host: dpy X server to use\n") ; 

fprintf ( stderr f " -geometry geom geometry of window\n") ; 

fprintf (stderr f "- b use backing store\n"); 

fprintf (stderr f " -fg color set foreground color\n") ; 

fprintf (stderr f " -bg color set background color\n") ; 

fprintf (stderr, " -bd color set border color\n") ; 

fprintf ( stderr , " -bw width set border width\n") ; 

fprintf (stderr, "\n"); 

exit (1); 
} 

/********•*•***•*****•**•*•**•****•****•***••••**•*** 

* doPhigsStuff 

* 

***************************************** 
doPhigsStuff (dpy f sdpy) 
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Display 
Display 



*dpy; 
*sdpy; 



static Ppoint 

Pxphigs__info 

Pconnid_x__drawable 

Ppoint 

Pint 

Ppoint3 



xyzpoints [] 
xinfo; 
conn; 
textjpt ; 
part = 1; 
rep; 



{{0.1, 0.1}, {0.9, 0.9}}; 



int 

float 

Ppoint 3 

Pvec3 

P limit 

Pmatrix3 

Pgse__stereo__view__indices 

Pgse_data 

unsigned long 

Ppoint_list3 



i, err; 

deg; 

tran, vrp; 

vpn f vup; 

wks_viewport, wks_window; 

rotmat, comp__mat, tranl; 

stereo_views ; 

gse__struct; 

xinfo__mask; 

point_list; 



xinfo. display = dpy; 

xinfo. rmdb = NULL; 

xinfo.appl_id.name = NULL; 

xinfo. appl__id. class = NULL; 

xinfo. args .argc_p = NULL; 

xinfo.args.argv = NULL; 

xinfo.flags.nojmonitor = 1; 
xinfo.flags.force__client_SS= 0; 

xinfo_mask - PXPHIGS_INFO_DISPLAY | PXPHIGS_INFO_FLAGS_NO_MON; 
popen_xphigs( (char*) NULL, PDEF_MEM__SIZE, xinfojnask, &xinfo) ; 

conn, display = sdpy; 

conn . drawable__id = stereo_win; 

popen_ws(stereo__wks, (Pconnid *) (&conn) , phigs_ws_type__x_drawable) , 

Sens it izeWindow (sdpy, stereo_win) ; 

XSync(sdpy, 0) ; 

pset_hlhsr_mode(stereo_wks, PHIGS_HLHSR_MODE_ZBUFF) ; 

conn. display = dpy; 

conn.drawable__id = mono__win; 

popen_ws (mono_wks , (Pconnid *) (ficonn) , phigs__ws__type_x_drawable ) ; 

Sens it izeWindow (dpy, mono_win) ; 

XSync(dpy, 0) ; 
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psetJilhsr_mode(mono_wks, PHIGS__HLHSR_MODE_ZBUFF) ; I 

wks_viewport . x__min =0.0; 
wks__viewport . x_max = winw; 
wks__viewport . y_min - 0.0; 
wks_viewport .y_max ■* winh; 
pset_ws___vp(stereo__wks, &wks_viewport) ; 

wks_viewport .x__max = mono_winw; 
wks__viewport ,y_max - mono__winh; 
pset_ws_yp (mono_wks , &wks__viewport) ; 

wks__window . x_min = 0.0; 
wks_window . x__max = 1.0; 
wks_window . y_min = 0.0; 
wks_w!ndow . y_max = 1.0; 
pset_ws_win(stereo_wks, &wks_window) ; 
pset_ws_win (mono__wks, &wks_window) ; 

/* Set Background color; entry of table. */ 
rep.x = 0.50; 
rep.y = .50; 
rep. z = 0.50; 

pset_colr_rep(stereo_wks, 0, &rep ); 
pset_colr_rep(mono_wks, 0, &rep ); 

rep .x *= 1.0; 
rep.y = 0.0; 
rep . z - 0.0; 
pset__colr_rep(stereo_wks, RED, &rep ); 
pset__colrjrep(mono__wks, RED, &rep ); 

rep .x = 0.0; 

rep . y = 1.0; 

rep . z = 0.0; 

pset__colr_rep(stereo_wks, GREEN, &rep ); 

pset_colr__rep(mono_wks, GREEN, &rep ); 

rep .x = 0.0; 

rep . y = . ; 

rep . z = 1.0; 

pset__colr_rep(stereo__wks, BLUE, &rep ); 

pset_colr_rep(mono__wks, BLUE, &rep ); ^ 
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rep.x = 1.0; 

rep.y = 1.0; 

rep.z = 0.0; 

pset_colr__rep(stereo_wks, YELLOW, &rep ); 

pset_colr__rep(mono_wks, YELLOW, &rep ); 

rep . x = 0.0; 

rep.y = 1.0; 

rep . z = 1.0; 

pset__colr_rep(stereo__wks, CYAN, Srep ); 

pset__colr_rep(mono_wks, CYAN f &rep ); 

rep.x = 1.0; 

rep . y = 0.0; 

rep . z = 1.0; 

pset_colr__rep(stereo_wks, MAGENTA, &rep ); 

pset_colr_rep(mono_wks, MAGENTA, &rep ); 



/* Viewing Stuff Common to Stereo and Mono */ 
/* Set up the left and right eye views */ 



vrp .x =0.0; vrp . y =0.0 

vpn.delta_x = 0.0; vpn.delta^ y =0.0 
vup . delta_x = 0.0; vup . delta_y =1.0 
peval__view_ori__matrix3 (&vrp, &vpn, &vup, &err, 

view_rep . ori_matrix) ; 
view__rep . clip_limit . x__min 
view__rep . clip_limit . xjmax 
view_rep . clip_limit . y_min 
view_rep . clip_limit . y_max 
view_rep . clip_limit . z_min 
view_rep . clip__limit . zjnax 
view_rep . xy_clip 
view_rep . back_clip 
view__rep . f ront__clip 



vrp . z =0.0 
vpn.delta__z = 1.0 
vup . delta_z =0.0 



= 0.0; 
= 1.0; 
= 0.0; 

- 1.0; 
= 0.0; 
= 1.0; 

= PIND_CLIP; 

= PIND_NO_CLIP; 

- PIND NO CLIP; 



mapping . win . xjmn 
mapping . win . x__max 
mapping . win . y_min 
mapping . win . y__max 
mapping . vp . z__min 
mapping . vp . z_max 
mapping . pro j_type 
mapping . pro j_ref __point . y 
mapping. pro j_ref_point . z 



-1.0 * VRC_WINDOW_SIZE/2.0; 

VRC_WINDOW_SIZE/2 . 0; 
-1.0 * WCJWINDOW_SIZE/2.0; 

VRC__WINDOW_SIZE/2 . 0; 
0.0; 
1.0; 

PTYPE_PERSPECT; 
0.0; 
VRC PRP; 
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mapping . view__plane 
mapping . backjplane 
mapping . f ront_plane 



-0.0; 

-100.0; 

mapping, pro j__ref_point.z - 1.0; 



C 



/* Viewing Stuff for Mono eye view */ 
mapping . vp . x_min = 0.0; 

mapping . vp . xjnax =1.0 

mapping . vp . y__min ==0.0 

mapping . vp . y_max = 1.0 

mapping. proj_ref_jpoint.x =0.0 
peval_view__map__matrix3 (fimapping, &err, 

view_rep.mapjmatrix) ; 
pset_yiew_j:ep3 (mono_wks, mono__view__index, &view_rep) ; 



/* Viewing Stuff for Stereo views */ 



mapping.vp.x_min =0.0 

mapping . vp f xjnax =1.0 

mapping . vp . y__min = 0.0 

mapping . vp . y_max =1.0 



/* left eye view */ 
mapping. pro j__refjpoint .x = -1.0 * half_occular__dist; 
peval_view_map__matrix3 (&mapping f &err, 

view_rep.map__matrix) ; 
pset_view__rep3 (stereo__wks, left_view_index, &view_rep) ; 

/* right eye view */ 
mapping. pro j_ref_point .x = halfj3ccular_dist; 
peval_viewjmap_matrix3 (fimapping, &err, 

view_rep.map__matrix) ; 
pset_view_rep3(stereo__wks / right_view_index, &view_rep) ; 



C 



/* Build the geometry structure */ 
/* . „ __ */ 

popen_struct ( structure) ; 



/* Replace the usual setviewind element with the STEREO VIEW INDICES GSE */ 



gse__struct . unsupp .size 
gse_struct . unsupp . data 
stereo__yiews .mono 
stereo__views . left 
stereo__yiews . right 



- sizeof (stereo__views) ; 
= (char *) &stereo__views; 
= left_yiew_index; 
■» left_jview_index; 
= right__view_index; 



C 
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pgse(PES_GSE_STEREO_VIEW_INDICES, &gse_struct) ; 
pset_hlhsr__id(PHIGS_HLHSR_ID__ON) ; 

/* Translate node for dials */ 
tran.x = 0.0; 
tran.y = 0.0; 
tran.z = 0.0; 
trans latere lem =3; 
ptranslate3 ( &tran, &err f tranl ) ; 
pset__local_tran3 ( tranl, PTYPE_PRECONCAT ); 

/* set initial degree of rotation to */ 
deg ■ 0.0; 
rotate_elem =4; 

protate_z ( deg f &err, comp__mat ) ; 
pset_local_tran3 ( comp_mat, PTYPE_PRECONCAT ); 

/* Translate node to offset object a little */ 
tran.x = .50; 
tran.y = 0.0; 
tran.z = 0.0; 

ptranslate3 ( &tran, &err f tranl ) ; 
pset_local__tran3 ( tranl, PTYPE__PRECONCAT ); 

pset_int_style ( PSTYLE_SOLID) ; 

pset_f ace__cull_mode ( PCULL__NONE ) ; 
pset_f ace_disting_mode ( PDISTING__NO ) ; 



pset__int_colr_ind ( BLUE); /* blue */ 
point_list .numjpoints - 4; 
point_list .points « cube[0]; 
pf ill_area3 (&point_list) ; 

pset_int__colr_ind ( GREEN); /* green */ 
po int__l is t .points = cube[l]; 
pf ill_area3 (&point__list) ; 

pset_int_colr__ind( RED); /* red */ 
point_list .points = cube [2]; 
pf ill_area3 (&point__list) ; 
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pset__int_colrjlnd( YELLOW);/* yellow */ 
point_list. points *= cube [3]; 
pf ill__area3 (&point_list) ; 

pset_int_colr_ind( CYAN); /* cyan */ 
point__list .points ■ cube [4]; 
pf ill_area3 (&point_list) ; 

pset_int_colr__ind( MAGENTA);/* magenta */ 
point__list .points = cube [5]; 
pf ill_area3 (&point_list) ; 

pclose_struct () ; 

/* set edit mode to replace */ 
pset_edit_mode (PEDIT_REPLACE) ; 

/* set display updates to wait */ 
pset_disp_upd_st (stereo_wks, PDEFER_WAIT, PMODE_NIVE) ; 
pset__disp_upd__st (mono_wks, PDEFER_WAIT, PMODE_NIVE) ; 

/* post the structure */ 
ppost_struct (stereo_wks, structure, 0.0); 
ppost__struct (mono__wks r structure, 0.0) ; 

/* Do the first display */ 
pupd__ws ( mono_wks, PUPD__PERFORM ); 

/* Go look for dial events, etc. */ 
MyMainLoop ( ) ; 

pclose__ws (stereo_wks) ; 
pclose__ws (mono_wks) ; 
pclose_jphigs () ; 

} /* End of doPhigsStuff */ 



* 

* MyMainLoop 
* 

* Custom loop so we can catch events 

* associated with the extensions to X Input and apply them to 

* PHIGS structures . 
* 
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int MyMainLoop ( ) 

{ 

int i f dials_values [10] , error, event s__wa it ing f nfds; 

unsigned long readfds f writefds, except fds; 

unsigned long monofdmask r stereofdmask; 

static int rotate__dirty, tran_dirty; 

Pvec3 tranval, scaleval; 

XEvent event , peek_event ; 

XAnyEvent *any_event; 

XButtonEvent button_event; 

XDeviceMotionEvent *dm; 

Display *current_dpy; 

/* Set up file descriptor masks */ 
monofdmask = 1 « mono_fd; 
stereofdmask = 1 « stereo_fd; 

/* Initialize the current screen pointer. */ 
current_dpy = dpy; 

/* Initialize the rotation-scale accumulation matrix */ 
identity__matrix(currmatrix) ; 

/* Initialize the translation accumulation vector */ 
tranval.delta__x = 0.0; tranval.delta__y = 0.0; t r an val.de It a_z = 0.0; 

/* Initialize the scale accumulation vector */ 
scaleval .delta__x = 1.0; s ca leval.de It a_y = 1.0; scaleval. delta_z = 1.0; 

/* Do forever */ 
for (;;) 
{ 

/* Use "select" to sleep on input from the two screens */ 
readfds = monofdmask | stereofdmask; 
writefds = 0; exceptfds =0; 

nfds = select (32 f Sreadfds, &writefds f &exceptfds, NULL) ; 
if (nfds — 0) 
continue; 

/* First get the event */ 

/* Check the Mono comm line */ 
if ( (readfds & monofdmask) != 0) 
{ 

if ( ( event s_wa it ing « XPending(dpy) ) != 0) 
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{ 

current__dpy -» dpy; 
XNextEvent (current_dpy, fievent) ; 
any_event » (XAnyEvent *) fievent; 
mode_flag ■* MONO; 
} 
} 

/* Check the Stereo comm line */ 
else if ( (readfds & stereofdmask) != 0) 
{ 

if ( ( event s__wa it ing = XPending(sdpy) ) !- 0) 
{ 

current__dpy = sdpy; 
XNextEvent (cur rent_dpy, fievent) ; 
any__event = (XAnyEvent *) Sevent; 
mode__flag = STEREO; 
} 
} 

else 
{ 

continue; 
} 

if ( (event . type == MapNotify) | | 
(event. type — Expose) | | 
(event. type == Conf igureNotify) ) 
{ 

if (any__event->window == mono__win) 
{ 

predraw_al Instructs (mono_wks, PFLAG_ALWAYS) ; 
XSync (current^ dpy f 0) ; 
} 

else if (any__event->window -■= stereo_win) 
{ 

predraw_al Instructs (stereo_wks, PFLAG__ALWAYS ) ; 
XSync ( currentjdpy , ) ; 
} 
} 

else if (event. type — LeaveNotify) 
{ 

if (any__event->window ™ stereo_rootwin) 
{ 

current__dpy = dpy; 
} 
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else if (any_event->window == mono__rootwin) 
{ 

current_dpy = sdpy; 
} 
} 

else if (event .type -« DeviceMotion) 
{ 

do 
{ 

peek__event . type = ; 

/* If this is a tablet event */ 
dm = (XDeviceMotionEvent *) &event; 
if (dm->deviceid == tablet__id) 
{ 

print f ("Tablet Motion\n") ; 
} 

/* If this is a dial event */ 
else if (dm->deviceid « dials__id) 
{ 

/* Now process the data for all dials. */ 
for (i ■= 0; i < dm->axes__count ; i++) 
{ 

/* Copy the new dial value */ 
if (dm->axis_data [i] != 0) 
{ 

dials_values [i + dm->first_axis ] = 
dm->axis_data [i] ; 
/* Set the dirty flag */ 
change [i+dm->first__axis] = 1; 
) 
} 

if (XPending(current__dpy) > 0) 
{ 

XPeekEvent ( current__dpy r &peek_event ) ; 
if ( pee k__e vent . type === DeviceMotion ) 
XNext E vent (cur rent_dpy r fievent) ; 
} 

} /* End of if this is a dial event */ 

} while ( peek_event . type -~ DeviceMotion ); /* End of do while */ 

/* Now Edit the PHIGS structure */ 
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rotate_dirty = FALSE; 
if (change [ XROTJD I AL] ) 
{ 

protate_x ( (float) dials_values [XROTJDIAL] /DIALSCALE, 
fierror, xrotmat ) ; 

rotate__dirty « TRUE; 
} 
else 

identity_matrix( xrotmat ); 

if (change [ YROTJD I AL] ) 
{ 

protate_y ( (float) dials_values [YROT_DIAL] /DIALSCALE, 
&error, yrotmat ) ; 

rotate_dirty - TRUE; 
} 
else 

identity_matrix ( yrotmat ) ; 

if (change [ZROTJDIAL] ) 
{ 

protate__z ( (float) dials_values [ZROT_DIAL] /DIALSCALE, 

fierror, zrotmat ) ; 
rotate__dirty = TRUE; 
} 
else 

identity__matrix( zrotmat ); 

if (change [SCALE_DIAL] ) 
{ 

s ca leval.de It a_x = 1.0 + 

(float ) dials__values [SCALEJDIAL] / (10 . 0*DIALSCALE) ; 

scaleval.delta_y = scaleval.delta_x; 

scaleval.delta__z » scaleval.delta_x; 

pscale3 ( fiscaleval, fierror, scalemat ); 

rotate_dirty » TRUE; 
} 
else 

identity_matrix( scalemat ); 

if (rotate__dirty -»■ TRUE) 
{ 

pcompose_matrix3 ( currmatrix, xrotmat, Serror, concatl ); 
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pcompose_matrix3 ( concatl f yrotmat, &error, concat2 ); 
pcompose_matrix3 ( concat2, zrotmat, Serror, concat3 )/ 
pcompose_matrix3 ( concat3 f scalemat, Serror, currmatrix ), 
popen__struct (structure) ; 
pset_edit_mode (PEDIT_REPLACE) ; 
pset_elemj?tr (rotate_elem) ; 

pset_local_tran3 ( currmatrix, PTYPE_PRECONCAT ); 
pclose_struct () ; 



} 



/* Change Translation Matrix */ 
tran_dirty = FALSE; 
if (change [XTRANJDIAL] ) 
{ 

tranval.delta_x += (float) dials_values [XTRAN_DIAL] /DIALSCALE; 

tran_dirty = TRUE; 
} 

if (change [YTRAN_DIAL] ) 
{ 

tranval ,delta_y += (float) dials_values [YTRAN_DIAL] /DIALSCALE; 

tran_dirty = TRUE; 
} 

if (change [ZTRAN_DIAL] ) 
{ 

tranval.delta__z += (float) dials_values [ZTRAN_DIAL] /DIALSCALE; 

tran_dirty = TRUE; 
} 

if (tran__dirty == TRUE) 
{ 

ptranslate3(&tranval f &error, tranmatrix) ; 

popen_struct (structure) ; 

pset_edit_mode (PEDIT_REPLACE) ; 

pset__elem_j>tr (trans late_elem) ; 

pset_local_tran3 ( tranmatrix, PTYPE_PRECONCAT ); 

pclose_struct () ; 
} 



if (mode__flag === STEREO) 
{ 

pupd__ws (stereo_wks, PUPD__PERFORM) ; 
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} 

else 
{ 

pupd__ws (mono_wks , PUPD__PERFORM) ; 
} 

for (i=0; i<8; i++) 
change [ i ] = ; 



} 



/* End of if event is DeviceMotion */ 
/* End of do forever */ 
/* End of MyMainLoop */ 



C 



* 

* main 
* 

main(argc f argv) 

int argc; 

char *argv[]; 
{ 

int amount, i, j ; 

char *geom = NULL; 

register int xdir f ydir; 

register int xoff, yoff; 

register int centerX, centerY; 

XSizeHints hints; 

XGCValues xgcv; 

XSetWindowAt tributes xswa; 

XWindowAt tributes winattr; 

Window root ; 

Colormap map; 

int x f y, w, h; 

int mono_button_x, mono_button_y, mono__button__w, 

mono_button_h ; 

int mono_button__bw, mono_button_Jbc, 

mono__buttonjDckgrnd; 

Font font ; 

char *fontname; 

XFontStruct *font info; 



( 



( 
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XGCValues gcvals; 

unsigned valmask; 

unsigned int d; 

unsigned int bw = 1; 

char *display - NULL; 

char *stereoDisplayString; 

Status status; 

char *strptr; 

char *fg = NULL; 

char *bg = NULL; 

char *bd = NULL; 

int fg_pix, bg_pix, bdjpix; 

XColor fg__def f fg_exact, bg_def, bg__exact, bd_def, bd__exact; 

int bs = NotUseful; 

Visual visual; 

int numscreens; 

xScreensInfo *screen info; 



ProgramName = argv[0]; 

for (i=l; i < argc; i++) 
{ 

char *arg = argv[i]; 

if (arg[0] == ' -' ) { 
switch (arg[l]) { 

case 'd': /* -display hostidpy */ 

if (++i >= argc) usage () ; 
display = argv[i]; 
continue; 
case ' g' : /* -geometry host:dpy */ 

if (++i >= argc) usage () ; 
geom = argv[i] ; 
continue; 
case f b r : /* -b or -bg or -bd */ 

if ( !strcmp(argv[i] , "-bg")) { 

if (++i >= argc) usage () ; 
bg = argv[i] ; 
} else if (!strcmp(argv[i], "-bd")) { 
if (++i >= argc) usage () ; 
bd = argv[i] ; 
} else if ( !strcmp(argv[i], "-bw")) { 
if (++i >= argc) usage () ; 
bw = atoi(argv[i] ) ; 
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__ _ 

} else 1 

bs = Always; 
continue; 
case ' £' : /* assume -fg */ 

if (++i >= argc) usage (); 
fg = argvfi] ; 
continue; 
default : 

usage ( ) ; 
} 
} else if (argv [i] [0] == '-') /* obsolete */ 

geom ■= argv[i] ; 
else 

usage () ; 
} 

if ( ! (dpy = XOpenDisplay (display) ) ) 
{ 

perror ("Cannot open display\n") ; 

exit (-1) ; 
} 

mono__fd = XConnectionNumber (dpy) ; 

/* Open the stereo screen for stereo windows. */ 
stereoDisplayString = XDisplayString (dpy) ; 
strptr = rindex (stereoDisplayString, ' :' ) ; 
XGetScreensInfo (dpy, &screen__info) ; 
numscreens = screen_info->numof screens; 
for (i=0; i<numscreens; i++) 
{ 

if (screen__info->screens [i] .screentype -= xStereoScreen) 

{ 

sprintf( (strptr + 1), "0.%d", i) ; 

} 
} 

if (!(sdpy ~ XOpenDisplay (stereoDisplayString) )) 
{ 

perror ("Cannot open display for Stereo screen\n") ; 

exit (-1) ; 
} 

stereo_fd ■= XConnectionNumber (sdpy) ; 
if (fg) { 



( 



( 
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status = XAllocNamedColor (dpy f map, fg, &fg__def, &fg__exact) ; 

fg_pix = status ? fg_def .pixel : WhitePixel (dpy, Def aultScreen (dpy) ) ; 
} else 

f g_j?ix = WhitePixel (dpy, Def aultScreen (dpy) ) ; 

if (bg) { 

status = XAllocNamedColor (dpy, map, bg, &bg_def, &bg__exact) ; 

bg_j>ix = status ? bg__def. pixel : BlackPixel (dpy, Def aultScreen (dpy) ) ; 
} else 

bg_j?ix = BlackPixel (dpy, Def aultScreen (dpy) ) ; 

if (bd) { 

status = XAllocNamedColor (dpy, map, bd, &bd_def, &bd_exact) ; 

bd_pix = status ? bd_def .pixel : WhitePixel (dpy, Def aultScreen (dpy) ) ; 
} else 

bdjpix = WhitePixel (dpy, Def aultScreen (dpy) ) ; 



if (geom) 
{ 

(void) XParseGeometry (geom, &mono_winx, &mono_winy, 
&mono_winw, &mono__winh) ; 
} 

xswa.backing_store = bs; 

xswa.event_mask = ExposureMask | StructureNotifyMask; 

xswa.background__pixel = bg_pix; 

xswa.border__pixel = bd_pix; 

visual. visualid = CopyFromParent; 

/* Select leave events on the mono root window */ 
mono_rootwin = RootWindow (dpy, Def aultScreen (dpy) ) ; 
XSelectlnput (dpy, mono_rootwin, LeaveWindowMask) ; 

/* Create Mono window */ 

if (mono_winh ■»= 0) 

mono__winh = 500; 

if (mono_winw == 0) 

mono__winw - 500; 

mono_win — XCreateWindow (dpy, 

RootWindow (dpy, Def aultScreen (dpy) ) , 
mono_winx, mono__winy, mono__winw, mono_winh, bw, 
Def aultDepth (dpy, Def aultScreen (dpy) ) , InputOutput, 
fivisual, 
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CWEventMask | CWBackingStore | CWBorderPixel I CWBackPixel, I 

&xswa) ; 
XChangeProperty(dpy, mono_win, XA__WM_NAME, XA_STRING, 8, 

PropModeReplace, "Stereo Demo", sizeof ("Stereo Demo") ); 
XMapWindow (dpy, mono_win) ; 

/* Select leave events on the stereo root window */ 
stereo_rootwin = RootWindow (sdpy, DefaultScreen (sdpy) ) ; 
XSelectlnput (sdpy, stereo_rootwin, LeaveWindowMask) ; 

/* Open the stereo window on the Stereo Screen */ 
winx =0; 
winy =0; 
winh = (XDisplayHeight (sdpy, DefaultScreen (sdpy) ) ) 

- 100 /* Fudge factor for borders */; 
winw = winh; 
stereo__win = XCreateWindow(sdpy, 

RootWindow (sdpy, DefaultScreen (sdpy) ) , 

winx, winy, winw, winh, bw, 

DefaultDepth(sdpy, DefaultScreen (sdpy) ) , InputOutput, 

fivisual, 

CWEventMask | CWBackingStore | CWBorderPixel | CWBackPixel, 

&xswa) ; 
XSync(sdpy, 0) ; 
XChangeProperty(sdpy, stereo__win, XA_WM__NAME, XA_STRING, 8, 

PropModeReplace, "Stereo Demo", sizeof ("Stereo Demo") ); 
hints. flags = USPosition | USSize ; 
hints.x = winx; 
hints.y = winy; 
hints. width = winw; 
hints. he ight= winh; 

XSetNormalHints (sdpy, stereo__win, fihints) ; 
XSetTransientForHint (sdpy, RootWindow (sdpy, DefaultScreen (sdpy) ) , 

stereo__win ) ; 
XSync(sdpy, 0) ; 
XMapWindow (sdpy, stereo_win) ; 
XFlush(sdpy, 0); 

doPhigsStuf f (dpy, sdpy) ; 

} /* End of main */ 



( 



( 
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* SensitizeWindow 
* 

* Routine to select input events for PHIGS graphics windows. 
•***************************^ 

int SensitizeWindow (my__dpy, my_window) 
Display *my_dpy; 
Window my_window; 

{ 

int i , j ; 

int eventCount = 0; 

XEventClass eventClass [100] ; 

XStringFeedbackControl strfc; 

KeySym ledstring[MAXDIALS] [CHARS_PER_DIAL] , blankled[CHARS_PER_DIAL] ; 

static char text st ring [MAXDIALS] [CHARS_PER__DIAL] = 

{ " X ROT ", " Y ROT ", " Z ROT ", " SCALE n , 
" X TRAN " f " Y TRAN " f " Z TRAN ", " " }; 

/* Get a list of the available devices */ 
devices - XListlnputDevices (my_dpy f &ndevices) ; 

/* Open the input devices */ 
for (i = 0; i < ndevices; i++, devices++) 
{ 

if ( st rcmp ("TABLET", device s->name) == 0) 
{ 

tablet_id = devices->id; 
tablet = XOpenDevice (my__dpy f tablet_id) ; 
} 

if (strcmp("KNOB_BOX", devices~>name) ~ 0) 
{ 

dials_id = devices->id; 

dials = XOpenDevice (my__dpy, dials_id) ; 

} 
} 
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eventCount « 0; 

if (! tablet) 
{ 

fprintf (stderr, "No TABLET\n w ) ; 
} 

else 
{ 

DeviceMotionNotify (tablet , DeviceMotion, eventClass [eventCount] ) ; 

eventCount ++ ; 

DeviceButtonPress (tablet, DevicePress, eventClass [eventCount] ) ; 
eventCount ++ ; 

DeviceButtonRelease (tablet, DeviceRelease, eventClass [eventCount] ) ; 

event Count ++; 
} 

if (Idials) 
{ 

fprintf (stderr, "No DIALS\n") ; 
} 

else 
{ 

DeviceMotionNotify (dials, DeviceMotion, eventClass [eventCount] ) ; 

eventCount++; 
} 



if (Idials && ! tablet) 
{ 

exit (0) ; 



XFreeDeviceList (devices) ; 

XSelectExtensionEvent (my_dpy, my_window, eventClass, eventCount); 

/* Set the dial labels */ 
/* Load the keysym arrays */ 
for (i = 0; i < MAXDIALS; i++) 

for (j = 0; j < CHARS_PER_DXAL; j++) 
{ 

ledstring[i] [j] = (KeySym) textstring[i] [ j] ; /* Dial labels */ 
blankled [ j ] - SPACEKEYSYM; /* Blank labels */ 

} 
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strfc. class = StringFeedbackClass; 

strfc. length = sizeof (XStringFeedbackControl) ; 

strfc.numjceysyms = CHARS__PER_DIAL; 

for (i=0; KMAXDIALS; i++) 

{ 

strfc. id - i; 

strfc.syms__to__display = ledstring[i] ; 

XChangeFeedbackControl (my_dpy, dials f DvString f &strf c) ; 
} 

return; 



/* End of SensitizeWindow */ 



/* End of stereo demo.c */ 
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